---
title: 🦛 Chonkie ✨
sidebarTitle: Introduction
description: The no-nonsense RAG chunking library that's lightweight, fast, and ready to CHONK your texts!
icon: "hippo"
iconType: "solid"
mode: wide
---
  
<img
  className="block dark:hidden"
  src="/images/chonkie_logo_br_transparent_bg.png"
  alt="Chonkie Logo Light"
/>
<img
  className="hidden dark:block"
  src="/images/chonkie_logo_br_transparent_bg.png"
  alt="Chonkie Logo Dark"
/>

Ever found yourself making a RAG pipeline yet again (your 2,342,148th one), only to realize you're stuck having to write chunking with bloated software library X or the painfully feature-less library Y?
_WHY CAN'T THIS JUST BE SIMPLE, UGH?_

Well, look no further than Chonkie! (chonkie boi is a gud boi 🦛)

<CardGroup cols={2}>
  <Card
    title="Feature-rich"
    icon="puzzle-piece"
  >
    All the CHONKs you'd ever need for your RAG applications
  </Card>
  <Card
    title="Easy to use"
    icon="wand-magic-sparkles"
  >
    Install, Import, CHONK - it's that simple!
  </Card>
  <Card
    title="Lightning Fast"
    icon="bolt"
  >
    CHONK at the speed of light! zooooom
  </Card>
  <Card
    title="Wide Support"
    icon="globe"
  >
    Supports all your favorite tokenizer, model and API CHONKs
  </Card>
  <Card
    title="Lightweight"
    icon="feather"
  >
    No bloat, just CHONK - only 9.7MB base installation
  </Card>
  <Card
    title="Cute Mascot"
    icon="hippo"
  >
    psst it's a pygmy hippo btw! Moto Moto approved
  </Card>
</CardGroup>
---

## Quick Start

Get started with Chonkie in three simple steps: Install, Import and CHONK!

```bash
pip install chonkie
```

Want more features? <Tooltip tip="Not recommended for production">Install everything</Tooltip>:
```bash
pip install chonkie[all]
```

<Note>
  Chonkie follows a special approach to dependencies, keeping the base installation lightweight while allowing you to add extra features as and when needed.
  Please check the [Installation](/python-sdk/getting-started/installation) page for more details.
</Note>

Release the CHONK! 🦛✨

```python
# First import the chunker you want from Chonkie 
from chonkie import TokenChunker

# Initialize the chunker
chunker = TokenChunker() # defaults to using GPT2 tokenizer

# Here's some text to chunk
text = """Woah! Chonkie, the chunking library is so cool!"""

# Chunk some text
chunks = chunker(text)

# Access chunks
for chunk in chunks:
    print(f"Chunk: {chunk.text}")
    print(f"Tokens: {chunk.token_count}")
```
--- 

### Chonkie Cloud
Don't wanna chunk locally? No problem! Chonkie Cloud is here to save the day!

1. Make a free account on [Chonkie Cloud](https://cloud.chonkie.ai)
2. Get your API key
3. Send your CHONK reqests! 

<CodeGroup>
  ```bash cURL
  curl -X POST \
     -H "Content-Type: application/json" \
     -H "Authorization: Bearer <YOUR_API_KEY>" \
     -d '{
           "text": "The tiny hippo lives in the clouds!",
           "args": {}
         }' \
     https://api.chonkie.ai/v1/chunk/<your-favorite-chunker>
  ```
  ```python Python
  # First import the chunker you want from Chonkie
  from chonkie.cloud import TokenChunker
  
  # Initialize the chunker
  # Don't forget to get your API key from cloud.chonkie.ai!
  chunker = TokenChunker(api_key=CHONKIE_API_KEY) 

  # Here's some text to chunk
  text = """The tiny hippo lives in the clouds!"""
  
  # Chunk some text
  chunks = chunker(text)
  
  # Access chunks
  for chunk in chunks:
    print(f"Chunk: {chunk.text}")
    print(f"Tokens: {chunk.token_count}")
  ```
</CodeGroup>

## Build With Chonkie

Ready to learn more about Chonkie?

<CardGroup cols={2}>
  <Card
    title="Concepts"
    icon="book"
    href="/common/concepts"
  >
    Learn about Chonkie's core concepts and values
  </Card>
  <Card
    title="Installation"
    icon="download"
    href="/python-sdk/getting-started/installation"
  >
    Learn about different installation options
  </Card>
  <Card
    title="Chunkers"
    icon="list"
    href="/python-sdk/chunkers/overview"
  >
    Explore different chunking strategies
  </Card>
  <Card
    title="Chonkie Cloud"
    icon="cloud"
    href="/common/cloud-overview"
  >
    Chonkie's hosted chunking service! 🦛☁️
  </Card>
  <Card
    title="Embeddings"
    icon="brain"
    href="/python-sdk/embeddings/overview"
  >
    Explore different embedding strategies
  </Card>
  <Card
    title="GitHub"
    icon="github"
    href="https://github.com/chonkie-inc/chonkie"
  >
    Star us on GitHub and contribute
  </Card>
</CardGroup>

---
## Support
Got questions? We're here to help!
<CardGroup cols={3}>
<Card
  title="Join our Discord"
  icon="discord"
  href="https://discord.gg/Q6zkP8w6ur"
  >
  Join our Discord community for support from Chonkers all over the world!
</Card>

<Card
  title="Open an issue"
  icon="bug"
  href="https://github.com/chonkie-inc/chonkie/issues/new"
  >
  Found a bug? Open an issue on GitHub and we'll fix it!
</Card>

<Card
  title="Email us"
  icon="envelope"
  href="mailto:support@chonkie.ai">
  Email the Chonkie team at support@chonkie.ai for any questions or feedback!
</Card>
</CardGroup>
